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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.111-1 "Fault Management; Part 1 : 3G fault management requirements" . 

32. 111-2 "Fault Management; Part 2: Alarm Integration Reference Point (IRP): Information Service (IS)". 

32.111-3 "Fault Management; Part 3: Alarm Integration Reference Point (IRP): Common Object 

Request Broker Architecture (CORBA) Solution Set (SS)". 

32. 111-5 "Fault Management; Alarm Integration Reference Point (IRP): extensible Markup Language 

(XML) definitions". 

32. 111-7 "Fault Management; Alarm Integration Reference Point (IRP): SOAP Solution Set (SS)". 



Scope 



The present contains the CORBA Solution Set for the IRP whose semantics is specified in Alarm IRP: Information 

Service (TS 32.111-2 [6]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 describes the notification interface containing the push method. Annex A contains the IDL specification. 

This Solution Set specification is related to TS 32.1 1 1-2 V7.1.X. 



£75/ 



3GPP TS 32.1 1 1 -3 version 8.1 .0 Release 8 5 ETSI TS 1 32 1 1 1 -3 V8.1 .0 (201 2-09) 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

http://www.omg.org/technologv/documents/ 

[2] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification), http://www.omg.org/technologv/documents/ 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.303: " Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[6] 3GPP TS 32. Ill -2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point: Information Service (IS)". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[8] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.1 1 1-2 [6] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

OMG Object Management Group 

TMN Telecommunications Management Network 

UML Unified Modelling Language 
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3.3 IRP document version number string 

The IRP document version number (sometimes called 'IRP version' or 'version number') string is used to identify the 
present document. The definition of 'IRP document version number string' in 3GPP TS 32.3 11 [8] provides the rule to 
derive such a string. 

This string is used for the return value of get_alarm_irp_versions(). It is used as return value of 
get_notification_categories() if the Notification IRP supports the emission of notifications defined by this Alarm IRP 
version. It is also used in the domain_name attribute of a structured event carrying alarm information defined by this 
Alarm IRP version. 



4 Architectural Features 

The overall architectural feature of Alarm IRP is specified in 3G TS 32.1 1 1-2 [6]. This clause specifies features that are 
specific to the CORBA SS. 

4.1 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Alarm Information to IRPManager via OMG Notification 
Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
AlarmlRPNotif ications notifications as specified in 3G TS 32.111-2 [6]. 

4.2 Push and Pull Style 

OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of Pull style is Optional (O). 

4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 
are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each push 
invocation. 

4.4 Filter 

IRP Agent shall optionally support alarm filtering based on IRPManager"s supplied alarm filter constraints (e.g. as 
parameter in subscribe() of 3G TS 32.302 [4]. Alarm filtering can be applied in the following cases: 

It is applicable to alarms emitted by IRP Agent via AlarmlRPNotif ications. IRPManager supplies alarm 
filter constraint via the subscribe method. This filter is effective during the period of subscription. 

It is applicable to alarms returned by IRP Agent via the out parameter of get_alarm_list method. 
IRPManager supplies alarm filter constraint via the get_alarm_list method. This filter is effective only for 
this method invocation. 
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It is applicable to the calculation of alarm counts returned by IRP Agent via the out parameters of 
get_alarm_count method. IRPManager supplies alarm filter constraint via the get_alarm_count 
method. This filter is effective only for this method invocation. 

This SS shall use of filter constraint grammar specified by reference OMG Notification Service [1]. The name of the 
grammar is called "EXTENDED_TCL". See clause 2.4, Default Filter Constraint Language in OMG Notification Service 
[1]. This SS shall use this grammar only. 
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5 Mapping 

5.1 Operation and Notification mapping 

Alarm IRP: IS 3G TS 32. 111-2 [6] defines semantics of operation and notification visible across the Alarm IRP. Table 1 indicates mapping of these operations and notifications 
to their equivalents defined in this SS. 

Table 1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 3G TS 32.111-2 [6] 


SS Method 


Qualifier 


acknowledgeAlarms 


acknowledge alarms 


M 


unacknowledgeAlarms 


unacknowledge alarms 


O 


getAlarmList 


get alarm list 


M 


getlRPVersion (note) 


get alarm irp versions 


M 


getAlarmCount 


get alarm count 





setComment 


comment alarms 





clearAlarms 


clear alarms 





getOperationProfile (note) 


get alarm irp operations profile 





getNotificationProfile (note) 


get alarm irp notificationjDrofile 





notifyNewAlarm 


push_structured_event 

Note that OMG Notification Service OMG Notification Service [1] defines this method. 

See clause 6.1 


M 


notifyClearedAlarm 


push_structured_event 
See clause 6.1 


M 


notifyChangedAlarm 


push_structured_event 
See clause 6.1 


M 


notifyAckStateChanged 


push_structured_event 
See clause 6.1 


M 


notifyAlarmListRebuilt 


push_structured_event 
See clause 6.1 


M 


notifyComments 


push_structured_event 
See clause 6.1 





notifyPotentialFaultyAlarmList 


push_structured_event 
See clause 6.1 





NOTE: This operation is of IVIanagedGenericIRP IOC specified in [7]. Tlie AlarmlRP IOC of [6] inherits from it. 
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5.2 Operation parameter mapping 



Reference 3G TS 32.111-2 [6] defines semantics of parameters carried in operations across the Alarm IRP. The following set of tables indicates the mapping of these 
parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS acknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformationAndSeverityReferenceList 


Alarm IRPConstDefs::AlarmlnformationldAndSevSeq alarm_infornnation_id_and_sev_list 
Note: perceivedSeverity is optional 

{ alarmld - IVIandatory; 

perceivedSeverity - Optional 

} 


M 


ackUserld 


string ack user id 


M 


ackSystemId 


IVIanagedGenericlRPConstDefs::StringOpt ack system id 





badAlarmlnformationReferenceList 


AlarmlRPConstDefs::BadAcknowledgeAlarmlnfoSeq bad ack alarm info list 


M 


status 


ManagedGenericlRPConstDefs::Signal 

Exceptions: 

AcknowledgeAlarms, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 3: Mapping from IS unacknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformationReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq alarm information id list 


M 


ackUserld 


string ack user id 


M 


ackSystemId 


IVIanagedGenericlRPConstDefs::StringOpt ack system id 





badAlarmlnformationReferenceList 


AlarmlRPGonstDefs:: BadAlarmlnformationldSeq bad alarm information id list 


M 


status 


ManagedGenericlRPConstDefs::Signal 

Exceptions: 

UnacknowledgeAlarms, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 4: Mapping from IS getAlarmList parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


IVIanagedGenericlRPConstDefsiiStringOpt filter 





baseObjectClass, baseObjectlnstance 


AlarmlRPConstDefs::DNOptbase_object 




(Note 1 


alarmlnformation List 


Return value of type AlarmlRPConstDefs::AlarmlnformationSeq (Note 2 


M 


status 


Exceptions: 

GetAlarmList, 

FilterComplexityLimit, 

ManagedGenericlRPSystem::ParameterNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 


Note 1 : If notification notif yAlarmListRebuilt supports indicating that only a part of the alarm list has been rebuilt then this parameter shall be supported. 
Note 2: Each Structured Event of AlarmlRPConstDefs::AlarmlnformationSeq shall have the fields defined in Table 4a or Table 4b. 
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Table 4a: Definition of a Structured Event of AlarmlRPConstDefs::AlarmlnformationSeq for alarms not related to security 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 




notificationType 


type_name 


M 


The parameter carries 

• NOTIFY_FM_NEW_ALARIVI of interface NotificationType of module Alarm IRPConstDefs in case 
the alarm has not yet changed and has not yet been cleared. 

• NOTIFY_FM_CHANGED_ALARIVI of interface NotificationType of module Alarm IRPConstDefs in 
case the alarm has changed but has not yet been cleared. 

• NOTIFY_FM_CLEARED_ALARM of interface NotificationType of module Alarm IRPConstDefs in 
case the alarm has been cleared but not yet acknowledged. 


alarmlype 


See Table 1 1 


M 


See Table 1 1 


Tliere is no corresponding SS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


See Table 1 1 


M 


See Table 1 1 


notificationid 


See Table 1 1 


M 


See Table 1 1 


eventTime 


See Table 1 1 


M 


Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 

The parameter carries the 

• alarmRaisedTime in case notificationType carries NOTIFY_FM_NEW_ALARIVI 

• alarmChangedTime in case notificationType carries NOTIFY_FM_CHANGED_ALARM 

• alarmClearedTime in case notificationType carries NOTIFY FM CLEARED ALARM 


system DN 


See Table 1 1 


M 


See Table 1 1 


alarmld 


See Table 1 1 


M 


See Table 1 1 


alarmRaisedTime 


One NV pair of filterable_ 
bodyjields 


M 


Name of NV pair Is the ALARMRAISEDTIME of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 


alarmClearedlime 


One NV pair of filterable_ 
bodyjields 


M 


present if related alarm was cleared; not present if related alarm was not cleared 

Name of NV pair is the ALARM_CLEARED_TIME of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 


probableCause 


See Table 1 1 


M 


See Table 1 1 


perceivedSeverity 


See Table 1 1 


M 


See Table 1 1 


specificProblem 


See Table 1 1 





See Table 1 1 


bacl<edUpStatus 


See Table 1 1 





See Table 1 1 


trendlndication 


See Table 1 1 





See Table 1 1 


tliresholdlnfo 


See Table 1 1 





See Table 1 1 


stateCliangeDefinition 


See Table 1 1 





See Table 1 1 


monitoredAttributes 


See Table 1 1 





See Table 1 1 


proposedRepairActions 


See Table 1 1 





See Table 1 1 


additionalText 


See Table 1 1 





See Table 1 1 
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IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


additionallnformation 


See Table 1 1 





See Table 1 1 


ackTime 


See Table 13 


M 


present if related alarm was acknowledged or unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table 13 


ackUserld 


See Table 1 3 


M 


present if related alarm was acknowledged or unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table 13 


ackSystemId 


See Table 13 





optionally present if related alarm was acknowledged or unacknowledged; not present if related alarm was 
not acknowledged or unacknowledged 

See Table 13 


ackState 


See Table 1 3 


M 


present if related alarm was acknowledged or unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table 13 


clearUserld 


See Table 14 





optionally present if related alarm was cleared; not present if related alarm was not cleared 
See Table 14 


clearSystemId 


See Table 14 





optionally present if related alarm was cleared; not present if related alarm was not cleared 
See Table 14 


backUpObject 


See Table 1 1 





See Table 1 1 


correlatedNotifications 


See Table 1 1 





See Table 1 1 


comments 


See Table 1 7 


M 


present if related alarm was commented; not present if related alarm was not commented 
See Table 17 


There is no corresponding IS 
attribute. 


remaining_ body 
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Table 4b: Definition of a Structured Event of AlarmlRPConstDefs::AlarmlnformationSeq for alarms related to security 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 




notificationType 


type_name 


M 


See Table 1 1 

The parameter carries 

• NOTIFY_FM_NEW_ALARIVI of interface NotificationType of module Alarm IRPConstDefs in case 
the alarm has not yet changed and has not yet been cleared. 

• NOTIFY_FM_CHANGED_ALARIVI of interface NotificationType of module Alarm IRPConstDefs in 
case the alarm has changed but has not yet been cleared. 

• NOTIFY_FM_CLEARED_ALARM of interface NotificationType of module Alarm IRPConstDefs in 
case the alarm has been cleared but not yet acknowledged. 


alarmlype 


See Table 1 1 


M 


See Table 1 1 


Tliere is no corresponding SS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


See Table 1 1 


M 


See Table 1 1 


notificationid 


See Table 1 1 


M 


See Table 1 1 


eventTime 


See Table 1 1 


M 


See Table 1 1 

The parameter carries the 

• alarmRaisedTime in case notificationType carries NOTIFY_FM_NEW_ALARM 

• alarmChangedTime in case notificationType carries NOTIFY_FIVI_CHANGED_ALARM 

• alarmClearedTime in case notificationType carries NOTIFY FIVI CLEARED ALARM 


system DN 


See Table 1 1 


M 


See Table 1 1 


alarmld 


See Table 1 1 


M 


See Table 1 1 


alarmRaisedTime 


One NV pair of filterable_ 
bodyjields 


M 


Name of NV pair is the ALARM_RAISED_TIME of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 


alarmClearedlime 


One NV pair of filterable_ 
bodyjields 


M 


present if related alarm was cleared; not present if related alarm was not cleared 

Name of NV pair is the ALARM_CLEARED_TIIVIE of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 


probableCause 


See Table 1 1 


M 


See Table 1 1 


perceivedSeverity 


See Table 1 1 


M 


See Table 1 1 


specificProblem 


See Table 1 1 





See Table 1 1 


additionalText 


See Table 1 1 





See Table 1 1 


additionallnformation 


See Table 1 1 





See Table 1 1 


acl<Time 


See Table 13 


M 


present if related alarm was acknowledged or unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 
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IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 








See Table 13 


ackUserld 


See Table 13 


M 


present if related alarm was acknowledged or unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table 13 


ackSystemId 


See Table 13 





optionally present if related alarm was acknowledged or unacknowledged; not present if related alarm was 
not acknowledged or unacknowledged 

See Table 13 


ackState 


See Table 13 


M 


present if related alarm was acknowledged or unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table 13 


clearUserld 


See Table 14 





optionally present if related alarm was cleared; not present if related alarm was not cleared 
See Table 14 


clearSystemId 


See Table 14 





optionally present if related alarm was cleared; not present if related alarm was not cleared 
See Table 14 


correlatedNotifications 


See Table 1 1 





See Table 1 1 


comments 


See Table 17 


M 


present if related alarm was commented; not present if related alarm was not commented 
See Table 17 


serviceUser 


See Table 12 


M 


See Table 12 


serviceProvider 


See Table 12 


M 


See Table 12 


securityAlarmDetector 


See Table 12 


M 


See Table 12 


There is no corresponding IS 
attribute. 


remainjng_ body 







Table 5: Mapping from IS getAlarmCount parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


ManagedGenericlRPConstDefs::StringOpt filter 





criticalCount, majorCount, minorCount, warningCount, 
indeterminateCount, clearedCount 


long critical_count, long major_count, long minor_count, long warning_count, long 
indeterminate count, long cleared count 


M 


status 


Exceptions: 

GetAlarmCount, 

FilterComplexityLimit, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenericlRPSystem::ParameterNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 
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Table 6: Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exceptions: 
GetAlarmlRPVersions 


M 



Table 7: Mapping from IS setcomment parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


alarmlnformationReferenceUst 


AlarmlRPConstDefs::AlarmlnformationldSeq alarm information id list 


M 


commentUserld 


string comment user id 


M 


commentSystemId 


ManagedGenericlRPConstDefs::StringOpt comment system id 





commentText 


string comment text 


M 


badAlarmlnformationReferenceList 


AlarmlRPConstDefs::BadAlarmlnformationldSeq bad alarm information id list 


M 


status 


ManagedGenericlRPConstDefs::Signal 

Exceptions: 

GommentAlarms, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 8: Mapping from IS getoperationProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


IVIanagedGenericlRPConstDefs::VersionNumber alarm irp version 


M 


operationNameProfile, operationParameterProfile 


Return value of type ManagedGenerJclRPConstDefs::IVIethodList 


M 


status 


Exceptions: 

GetAlarmlRPOperationsProfile, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 



Table 9: Mapping from IS getNotificationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPConstDefs::VersionNumber alarm irp version 


M 


notificationNameProfile, notificationParameterProfile 


Return value of type IVIanagedGenericlRPConstDefs::MethodList 


M 


status 


Exceptions: 

GetAlarmlRPNotificationProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 10: Mapping from IS clearAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformationReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq alarm information id list 


M 


clearUserld 


string clear user id 


M 


clearSystemId 


string clear system id 





badAlarmlnformationReferenceUst 


AlarmlRPConstDefs:: BadAlarmlnformationldSeq bad alarm information id list 


M 


status 


ManagedGenericlRPConstDefs::Signal 

Exceptions: 

ClearAlarms, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Reference 3G TS 32.111-2 [6] defines semantics of parameters carried in notifications. The following tables indicate the mapping of these parameters to their OMG CORBA 
Structured Event (defined in OMG Notification Service [1]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [1], is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the Alarm IRP: IS [6] defined notification parameters. 

Table 11: Mapping for notifyNewAlarm (to carry non-security-related alarms) 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no corresponding 
SS attribute. 


domainname 


M 


It carries the IRP document version number string. See sub-clause 3.3. 

It indicates the syntax and semantics of the Structured Event as defined by this specification. 


notificationlype 


type name 


M 


This is the NOTIFY FM NEW ALARM of interface NotificationType of module AlarmlRPConstDefs. 


alarmType 


event_name 


M 


It identifies one of the following: 
communications alarm, 
processing error alarm, 
environmental alarm, 
quality of service alarm and 
equipment alarm. 

It is a string defined by interface AlarmType of module AlarmlRPConstDefs. 


Tliere is no corresponding 
SS attribute. 


variable Header 


M 




objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface AttributeNameValue of module NotificationlRPConstDefs. 
Value of NV pair is a long. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIIVIE of interface AttributeNameValue of module Notification IRPConstDefs. 
Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 


system DN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationlRPConstDefs. 
Value of NV pair is a string. 


probableCause 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PROBABLE_CAUSE of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a short defined by interface ProbableCause of module AlarmlRPConstDefs. 


perceivedSeverity 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PERCEIVED_SEVERITY of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a short defined by interface PerceivedSeverity of module AlarmlRPConstDefs. 


specificProblem 


One NV pair of 
remaining_body 





Name of NV pair is the SPECIFIC_PROBLEM of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a string. 


correlatedNotifications 


One NV pair of 
remaining_body 





Name of NV pair is the CORRELATED_NOTIFICATIONS of interface AttributeNameValue. 
Value of NV pair is a CorrelatedNotificationSet of module AlarmlRPConstDefs. 


backedUpStatus 


One NV pair of 
remaining_body 





Name of NV pair is the BACKED_UP_STATUS of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a boolean BackedUpStatus of module AlarmlRPConstDefs. 


backUpObject 


One NV pair of 
remaining_body 





Name of NV pair is the BACK_UP_OBJECT of interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string carrying of DN of the back-up object. See 3G TS 32.300 [3] for the DN string 
representation. 


trendlndication 


One NV pair of 
remaining_body 





Name of NV pair is the TRENDJNDICATION of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is an enum Trendlndication of module AlarmlRPConstDefs. 


thresholdlnfo 


One NV pair of 
remainingbody 





Name of NV pair is the THRESHOLDJNFO of interface ParameterNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a Thresholdlnfo of module AlarmlRPConstDefs. 


stateChangeDefinition 


One NV pair of 
remaining_body 





Name of NV pair is the STATE_CHANGE_DEFINITION of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is an AttributeChangeSet of module AlarmlRPConstDefs. 


monitoredAttributes 


One NV pair of 
remaining_body 





Name of NV pair is the MONITORED_ATTRIBUTES of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is an AttributeSet of module AlarmlRPConstDefs. 


proposedRepairActions 


One NV pair of 
remaining_body 





Name of NV pair is the PROPOSED_REPAIR_ACTIONS of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


additionalText 


One NV pair of 
remaining_body 





Name of NV pair is tlie ADDITIONAL_TEXT of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a string. 


additionallnformation 


One or more NV pairs of 
remaining_body 





3GPP defines two Additional Information (Al) NV pairs for carrying vendor-specific (VS) perceived severity and 

alarm type. 

The names of these two NV pairs are: 

• Al VS PERCEIVED SEVERITY 

• AI_VS_ALARM_TYPE 

of interface Additionallnformation of module AlarmlRPConstDefs. 

The values of these two NV pairs are vendor defined. 

Other Al NV pairs are permitted to capture specific information. 

To be easily identified as vendor specific, the name value of these NV pairs should take the form of "ai_vs_<non- 

empty string>". 

The value of this NV pair is vendor defined. 


alarmld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ALARMJD of interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, the default semantics is that alarmld is a 
concatenation of managedObjectlnstance, eventType, probableCause and specificProblem, if present, of this 
Structured Event. Since probableCause is encoded as a short, it shall be converted into string before 
concatenation. The resultant string shall not contain spaces. 
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Table 12: Mapping for notifyNewAlarm (to carry security alarm) 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 

It indicates the syntax and semantics of the Structured Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NOTIFY_FIVI_NEW_ALARM of interface NotificationType of module AlarmlRPConstDefs. 


alarmlype 


event_name 


M 


It identifies one of the following: 

Integrity violation, operational violation, physical violation, security violation and time domain violation. 

It is a string defined by interface Alarm Type of module AlarmlRPConstDefs. 


There is no 
corresponding SS 
attribute. 


variable Header 


M 




objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface AttributeNameValue of module NotificationlRPConstDefs. 
Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationlRPConstDefs. 
Value of NV pair is a IRPTime of module ManagedGenericlRPConstDefs. 


system DN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationlRPConstDefs. 
Value of NV pair is a string. 


probableCause 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PROBABLE_CAUSE of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a short defined by interface ProbableCause of module AlarmlRPConstDefs. 


perceivedSeverity 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PERCEIVED_SEVERITY of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a short defined by interface PerceivedSeverity of module AlarmlRPConstDefs. 


correlatedNotifications 


One NV pair of 
remainingbody 





Name of NV pair is the CORRELATED_NOTIFICATIONS of interface AttributeNameValue. 
Value of NV pair is a CorrelatedNotificationSet of module AlarmlRPConstDefs. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


additionalText 


One NV pair of 
remaining_body 





Name of NV pair is tlie ADDITIONAL_TEXT of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a string. 


additionallnformation 


One or more NV pairs of 
remainJng_body 





3GPP defines two Additional Information (Al) NV pairs for carrying vendor-specific (VS) perceived severity and 

alarm type. 

The names of these two NV pairs are: 

• Al VS PERCEIVED SEVERITY 

• AI_VS_ALARM_TYPE 

of interface Additionallnformation of module AlarmlRPConstDefs. 

The values of these two NV pairs are vendor defined. 

Other Al NV pairs are permitted to capture specific information. 

To be easily identified as vendor specific, the name value of these NV pairs should take the form of 

"ai_vs_<non-empty string>". 

The value of this NV pair is vendor defined. 


alarmld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ALARM_ID of interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, the default semantics is that alarmld is a 
concatenation of managedObjectlnstance, eventType, probableCause and specificProblem, if present, of this 
Structured Event. Since probableCause is encoded as a short, it shall be converted into string before 
concatenation. The resultant string shall not contain spaces. 


serviceUser 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SERVICE_USER of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a string. 


serviceProvider 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SERVICE_PROVIDER of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a string. 


securityAlarmDetector 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SECURITY_ALARM_DETECTOR of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 
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Table 13: Mapping for notifyAckStateChanged 



IS Parameters 


OMG CORBA Structured Event 
attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 


See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FIVI_ACK_STATE_CHANGED of interface NotificationType of module 
AlarmlRPConstDefs. 


alarmlype 


event name 


M 


See that of notifyNewAlarm. 


Tliere is no corresponding IS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


system DN 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


acl<Userld 


One NV pair of remaining_body 


M 


Name of NV pair is the ACK_USERJD of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 


acl<Systemld 


One NV pair of remaining_body 





Name of NV pair is the ACK_SYSTEIVI_ID of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 


acl<State 


One NV pair of remaining_body 


M 


Name of NV pair is the ACK_STATE of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface AckState of module AlarmlRPConstDefs. 
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Table 14: Mapping for notifyClearedAlarm 



IS Parameters 


OMG CORBA Structured Event 
attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 


See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_CLEARED_ALARM of interface NotificationType of module 
AlarmlRPConstDefs. 


alarmlype 


event name 


M 


See that of notifyNewAlarm. 


Tliere is no corresponding IS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


system DN 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


correlatedNotifications 


- 


- 


See Note. 


alarmld 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


clearUserld 


One NV pair of remaining_body 





Name of NV pair is the CLEARUSERJD of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 


clearSystemId 


One NV pair of remaining_body 





Name of NV pair is the CLEAR_SYSTEI\/I_ID of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 


NOTE: In the CORBA Solution Set the correlatedNotifications is not used. In the CORBA Solution Set, one notifyClearedAlarm notification can only clear a single 
alarmlnformation. 
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Table 15: Mapping for notifyAlarmListRebuilt 



IS Parameters 


OMG CORBA Structured Event 
attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 


See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FIVI_ALARM_LIST_REBUILT of interface NotificationType of module 
AlarmlRPConstDefs. 


Tliere is no corresponding IS 
attribute. 


event_name 


M 


Carry an empty string. 


Tliere is no corresponding IS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


system DN 


One NV pair of 
filterable body fields 





See that of notifyNewAlarm. 


reason 


One NV pair of remaining_body 


M 


Name of NV pair is the REASON of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 


alarmListAlignmentRequirement 


One NV pair of remainJng_body 





Name of NV pair is the ALARM_LIST_ALIGNMENT_REOUIREMENT of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an enum AlarmListAlignmentRequirement of module AlarmlRPConstDefs. 
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Table 16: Mapping for notifyChangedAlarm 



IS Parameters 


OIMG CORBA Structured Event 
attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 


See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_CHANGED_ALARM of interface NotificationType of module 
AlarmlRPConstDefs. 


alarmlype 


event name 


M 


See that of notifyNewAlarm. 


Tliere is no corresponding IS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


system DN 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


perceived Severity 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of remaining_body 


M 


See that of notifyNewAlarm. 



Table 17: Mapping for notifyComments 



IS Parameters 


OMG CORBA Structured Event 
attribute 


Qualifier 


Comment 


There is no corresponding IS 
attribute. 


domain_name 


M 


See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_COMMENT_ADDED of interface NotificationType of module 
AlarmlRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no corresponding IS 
attribute. 


variable Header 


M 




objectClass, objectlnstance 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


system DN 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of remaining body 


M 


See that of notifyNewAlarm. 


comments 


One NV pair of remainingbody 


M 


Name of NV pair is the COIVIMENTS of interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a CommentSet of module AlarmlRPConstDefs. 
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Table 18: Mapping for notifyPotentialFaultyAlarmList 



IS Parameters 


OMG CORBA Structured Event 
attribute 


Qualifier 


Comment 


There is no corresponding 
IS attribute. 


domain_name 


M 


See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_POTENTIAL_FAULTY_ALARM_LIST of interface NotificationType of module 
AlarmlRPConstDefs. 


Tliere is no corresponding 
IS attribute. 


event_name 


M 


It contains a NULL string. 


There is no corresponding 
IS attribute. 


variable Header 


M 




objectClass, objectlnstance 


One NV pair of 
filterable_body_fields 


M 


See notifyNewAlarm. 

See sub-clause 'Definition' of this notification in [6] for the description of the usage of this field to indicate 
if part or all AlarmList is potentially faulty. 


notificationid 


One NV pair of remaining body 


M 




eventTime 


One NV pair of 
filterable body fields 


M 


See notifyNewAlarm. 


system DN 


One NV pair of 
filterable body fields 


M 


See notifyNewAlarm. 


reason 


One NV pair of remainingbody 


M 


Name of NV pair is the REASON of interface AttributeNameValue of module AlarmlRPConstDefs. 
Value of NV pair is a string. 



£75/ 



3GPP TS 32.1 1 1 -3 version 8.1 .0 Release 8 27 ETSI TS 1 32 11 1 -3 V8.1 .0 (201 2-09) 



6 AlarmlRPNotifications Interface 



OMG CORBA Notification push operation is used to realise the notification of AlarmlRPNotifications. All the notifications in this interface are implemented using this 
push_structured_event method. 

6.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events ( 

in CosNotif ication: lEventBatch notifications) 
raises ( CosEventComm: : Disconnected) ; 

} ; // SequencePushConsumer 

} ; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined in the OMG CosNotif ication module (OMG 
Notification Service [1]). This data type is the same as a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate individual events into the sequence before invoking this operation 
is controlled by IRP Agent wide configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name "AlarmlRPConstDefs.idI") 

//File: AlarmlRPConstDefs.idI 

#ifndef _ALARM_IRP_CONST_DEFS_IDL_ 

#define _ALARM_IRP_CONST_DEFS_IDL_ 

#include <CosNotif ication. idl> 

#include <ManagedGenericIRPConstDef s . idl> 

// This statement must appear after all include statements 

#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPConstDefs 

This module contains commonly used definitions for Alarm IRP 



*/ 

module AlarmlRPConstDefs 

{ 

/* 

The format of Distinguished Name (DN) is specified in 3GPP TS 32.300 

"Name Conventions for Managed Objects". 

*/ 

typedef string DN; 

/* DNOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise the value is null. 

*/ 

union DNOpt switch (boolean) 

{ 

case TRUE: DN value; 

}; 
/* 

This block identifies the alarm types specified for this IRP version. 

These types carry the same semantics as the TMN ITU-T defined event 

types of the same name. 

Their encodings for this version of Alarm IRP are defined here. Other IRP 

documents, or other versions of Alarm IRP, shall identify their own 

alarm types for their use. They shall define their encodings 

as well. Values defined here are unique among themselves. 

*/ 

interface AlarmType 

{ 

const string COMMUNICATIONS_ALARM = "xl"; 

const string PROCESSING_ERROR_ALARM = "x2"; 

const string ENVIRONMENTAL_ALARM = "x3"; 

const string QUALITY_OF_SERVICE_ALARM = "x4"; 

const string EQUI PMENT_ALARM = "x5"; 

const string INTEGRITY_VIOLATION = "xS"; 

const string OPERATIONAL_VIOLATION = "x7"; 

const string PHYSICAL_VIOLATION = "x8"; 

const string SECURITY_SERVICE_OR_MECHANISM_VIOLATION = "x9"; 

const string TIME_DOMAIN_VIOLATION = "xlO"; 

}; 
/* 

This block identifies the notification types defined by this 

Alarm IRP version. 

*/ 

interface Notif icationType 

{ 

const string NOTIFY_FM_NEW_ALARM = "xl"; 

const string NOTIFY_FM_CHANGED_ALARM = "x2"; 

const string NOTIFY_FM_ACK_STATE_CHANGED = "x3"; 

const string NOTIFY_FM_COMMENT_ADDED = "x4"; 

const string NOTIFY_FM_CLEARED_ALARM = "x5"; 

const string NOTIFY_FM_ALARM_LIST_REBUILT = "x6"; 

const string NOTIFY_FM_POTENTIAL_FAULTY_ALARM_LIST = "x7"; 



/* 

This block identifies the levels of severity. 

*/ 

interface PerceivedSeverity 
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const short INDETERMINATE = 1 ; 
const short CRITICAL = 2 ; 
const short MAJOR = 3 ; 
const short MINOR = 4 ; 
const short WARNING = 5 ; 
const short CLEARED = 6 ; 

}; 
/* 

This block identifies the probable cause of a reported alarm. 

*/ 

interface ProbableCause 

{ 

/* 

Probable causes originating from M.3100. 

Values below correspond to M.3100 values. 

const short INDETERMINATE = 0; 

const short ALARM_INDICATION_SIGNAL = 1; 

const short CALL_SETUP_FAILURE = 2 ; 

const short DEGRADED_SIGNAL = 3 ; 

const short FAR_END_RECEIVER_FAILURE = 4; 

const short FRAMING_ERROR = 5; 

const short LOSS_OF_FRAME = 6 ; 

const short LOSS_OF_POINTER = 7 ; 

const short LOSS_OF_SIGNAL = 8 ; 

const short PAYLOAD_TYPE_MISMATCH = 9 ; 

// Values 10 correspond to a duplicated probable cause 

const short REMOTE_ALARM_INTERFACE = 11; 

const short EXCESSIVE_BIT_ERROR_RATE = 12; 

const short PATH_TRACE_MISMATCH = 13; 

const short UNAVAILABLE = 14; 

const short SIGNAL_LABEL_MISMATCH = 15; 

const short LOSS_OF_MULTI_FRAME = 16; 

const short COMMUNICATIONS_RECEIVE_FAILURE = 17; 

const short COMMUNICATIONS_TRANSMIT_FAILURE = 18; 

const short MODULATION_FAILURE = 19; 

const short DEMODULATION_FAILURE = 20; 

// Values 21-26 correspond to duplicated probable causes 

// Values 27-50 are reserved for M.3100 potential future extensions 

const short BACK_PLANE_FAILURE = 51; 

const short DATA_SET_PROBLEM = 52; 

const short EQUIPMENT_IDENTIFIER_DUPLICATION = 53; 

const short EXTERNAL_IF_DEVICE_PROBLEM = 54; 

const short LINE_CARD_PROBLEM = 55; 

const short MULTIPLEXER_PROBLEM = 56; 

const short NE_IDENTIFIER_DUPLICATION = 57; 

const short POWER_PROBLEM = 58; 

const short PROCESSOR_PROBLEM = 59; 

const short PROTECTION_PATH_FAILURE = 60; 

const short RECEIVER_FAILURE = 61; 

const short REPLACEABLE_UNIT_MISSING = 62; 

const short REPLACEABLE_UNIT_TYPE_MISMATCH = 63; 

const short SYNCHRONIZATION_SOURCE_MISMATCH = 64; 

const short TERMINAL_PROBLEM = 65; 

const short TIMING_PROBLEM = 66; 

const short TRANSMITTER_FAILURE = 67; 

const short TRUNK_CARD_PROBLEM = 68; 

const short REPLACEABLE_UNIT_PROBLEM = 69; 

const short REAL_TIME_CLOCK_FAILURE = 70; 

// Values 71-80 correspond to duplicated probable causes 

const short PROTECTION_MECHANISM_FAILURE = 81; 

const short PROTECTING_RESOURCE_FAILURE = 82; 

// Values 83-100 are reserved for M.3100 potential future extensions 

const short AIR_COMPRESSOR_FAILURE = 101; 

const short AIR_CONDITIONING_FAILURE = 102; 

const short AIR_DRYER_FAILURE = 103; 

const short BATTERY_DISCHARGING = 104; 

const short BATTERY_FAILURE = 105; 

const short COMMERCIAL_POWER_FAILURE = 106; 

const short COOLING_FAN_FAILURE = 107; 

const short ENGINE_FAILURE = 108; 

const short FIRE_DETECTOR_FAILURE = 10 9; 

const short FUSE_FAILURE = 110; 

const short GENERATOR_FAILURE = 111; 

const short LOW_BATTERY_THRESHOLD = 112; 

const short PUMP_FAILURE = 113; 

const short RECTIFIER FAILURE = 114; 
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const short RECTIFIER_HIGH_VOLTAGE = 115; 

const short RECTIFIER_LOW_F_VOLTAGE = 116; 

const short VENTILATION_SYSTEM_FAILURE = 117; 

const short ENCLOSURE_DOOR_OPEN = 118; 

const short EXPLOSIVE_GAS = 119; 

const short FIRE = 120; 

const short FLOOD = 121; 

const short HIGH_HUMIDITY = 122; 

const short HIGH_TEMPERATURE = 123; 

const short HIGH_WIND = 124; 

const short ICE_BUILD_UP = 125; 

const short INTRUSION_DETECTION = 126; 

const short LOW_FUEL = 12 7; 

const short LOW_HUMIDITY = 128; 

const short LOW_CABLE_PRESSURE = 12 9; 

const short LOW_TEMPERATURE = 13 0; 

const short LOW_WATER = 131; 

const short SMOKE = 132; 

const short TOXIC_GAS = 133; 

// Values 134-135 correspond to duplicated probable causes 

const short EXTERNAL_POINT_FAILURE = 136; 

// Values 137-150 are reserved for potential M.3100 future extensions 

const short STORAGE_CAPACITY_PROBLEM = 151; 

const short MEMORY_MISMATCH = 152; 

const short CORRUPT_DATA = 153; 

const short OUT_OF_CPU_CYCLES = 154; 

const short SOFTWARE_ENVIRONMENT_PROBLEM = 155; 

const short SOFTWARE_DOWNLOAD_FAILURE = 156; 

const short LOSS_OF_REAL_TIME = 157; 

const short REINITIALIZED = 158; 

// Values 159-167 correspond to duplicated probable causes 

// Values 168-200 are reserved for potential M.3100 future extensions 

// Values 201-202 correspond to duplicated probable causes 

const short EXCESSIVE_ERROR_RATE = 203; 

// Values 204-207 correspond to duplicated probable causes 

// Values 208-300 are reserved for potential M.3100 future extensions 

/* 

Probable causes originating from X.721. 

Values below correspond to X.721 values with an offset of 300. 

const short ADAPTER_ERROR = 301; 

const short APPLICATION_SUBSYSTEM_FAILURE = 302; 

const short BANDWIDTH_REDUCED = 303; 

// Value 304 corresponds to a duplicated probable cause 

const short COMMUNICATIONS_PROTOCOL_ERROR = 305; 

const short COMMUNICATIONS_SUBSYSTEM_FAILURE = 306; 

const short CONFIGURATION_OR_CUSTOMIZATION_ERROR = 307; 

const short CONGESTION = 308; 

// Value 309 corresponds to a duplicated probable cause 

const short CPU_CYCLES_LIMIT_EXCEEDED = 310; 

const short DATA_SET_OR_MODEM_ERROR = 311; 

// Value 312 corresponds to a duplicated probable cause 

const short DTE_DCE_INTERFACE_ERROR = 313; 

// Value 314 corresponds to a duplicated probable cause 

const short EQUIPMENT_MALFUNCTION = 315; 

const short EXCESSIVE_VIBRATION = 316; 

const short FILE_ERROR = 317; 

// Values 318-320 correspond to duplicated probable causes 

const short HEATING_OR_VENTILATION_OR_COOLING_SYSTEM_PROBLEM = 321; 

const short HUMIDITY_UNACCEPTABLE = 322; 

const short INPUT_OUTPUT_DEVICE_ERROR = 323; 

const short INPUT_DEVICE_ERROR = 324; 

const short LAN_ERROR = 325; 

const short LEAK_DETECTED = 326; 

const short LOCAL_NODE_TRANSMISSION_ERROR = 327; 

// Values 328-329 correspond to duplicated probable causes 

const short MATERIAL_SUPPLY_EXHAUSTED = 330; 

// Value 331 corresponds to a duplicated probable cause 

const short OUT_OF_MEMORY = 332; 

const short OUTPUT_DEVICE_ERROR = 333; 

const short PERFORMANCE_DEGRADED = 334; 

// Value 335 corresponds to a duplicated probable cause 

const short PRESSURE_UNACCEPTABLE = 336; 

// Values 337-338 correspond to duplicated probable causes 

const short QUEUE_SIZE_EXCEEDED = 339; 

const short RECEIVE_FAILURE = 34 0; 

// Value 341 corresponds to a duplicated probable cause 

const short REMOTE NODE TRANSMISSION ERROR = 342; 
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const short RESOURCE_AT_OR_NEARING_CAPACITY = 343; 

const short RESPONSE_TIME_EXCESSIVE = 344; 

const short RETRANSMISSION_RATE_EXCESSIVE = 345; 

const short SOFTWARE_ERROR = 346; 

const short SOFTWARE_PROGRAM_ABNORMALLY_TERMINATED = 347; 

const short SOFTWARE_PROGRAM_ERROR = 348; 

// Value 349 corresponds to a duplicated probable cause 

const short TEMPERATURE_UNACCEPTABLE = 350; 

const short THRESHOLD_CROSSED = 351; 

// Value 352 corresponds to a duplicated probable cause 

const short TOXIC_LEAK_DETECTED = 353; 

const short TRANSMIT_FAILURE = 354; 

// Value 355 corresponds to a duplicated probable cause 

const short UNDERLYING_RESOURCE_UNAVAILABLE = 356; 

const short VERSION_MISMATCH = 357; 

// Values 358-500 are reserved for potential X.721 future extensions 

/* 

Probable causes for 2G & 3G wireless systems. 

*/ 

const short A_BIS_TO_BTS_INTERFACE_FAILURE = 501; 

const short A_BIS_TO_TRX_INTERFACE_FAILURE = 502; 

const short ANTENNA_PROBLEM = 503; 

const short BATTERY_BREAKDOWN = 5 04; 

const short BATTERY_CHARGING_FAULT = 505; 

const short CLOCK_SYNCHRONIZATION_PROBLEM = 506; 

const short COMBINER_PROBLEM = 5 07; 

const short DISK_PROBLEM = 508; 

// Value 509 corresponds to a duplicated probable cause 

const short EXCESSIVE_RECEIVER_TEMPERATURE = 510; 

const short EXCESSIVE_TRANSMITTER_OUTPUT_POWER = 511; 

const short EXCESSIVE_TRANSMITTER_TEMPERATURE = 512; 

const short FREQUENCY_HOPPING_DEGRADED = 513; 

const short FREQUENCY_HOPPING_FAILURE = 514; 

const short FREQUENCY_REDEFINITION_FAILED = 515; 

const short LINE_INTERFACE_FAILURE = 516; 

const short LINK_FAILURE = 517; 

const short LOSS_OF_SYNCHRONIZATION = 518; 

const short LOST_REDUNDANCY = 519; 

const short MAINS_BREAKDOWN_WITH_BATTERY_BACKUP = 52 0; 

const short MAINS_BREAKDOWN_WITHOUT_BATTERY_BACKUP = 521; 

const short POWER_SUPPLY_FAILURE = 522; 

const short RECEIVER_ANTENNA_FAULT = 523; 

// Value 524 corresponds to a duplicated probable cause 

const short RECEIVER_MULTICOUPLER_FAILURE = 525; 

const short REDUCED_TRANSMITTER_OUTPUT_POWER = 526; 

const short SIGNAL_QUALITY_EVALUATION_FAULT = 527; 

const short TIMESLOT_HARDWARE_FAILURE = 528; 

const short TRANSCEIVER_PROBLEM = 52 9; 

const short TRANSCODER_PROBLEM = 530; 

const short TRANSCODER_OR_RATE_ADAPTER_PROBLEM = 531; 

const short TRANSMITTER_ANTENNA_FAILURE = 532; 

const short TRANSMITTER_ANTENNA_NOT_ADJUSTED = 533; 

// Value 534 corresponds to a duplicated probable cause 

const short TRANSMITTER_LOW_VOLTAGE_OR_CURRENT = 535; 

const short TRANSMITTER_OFF_FREQUENCY = 536; 

const short DATABASE_INCONSISTENCY = 537; 

const short FILE_SYSTEM_CALL_UNSUCCESSFUL = 538; 

const short INPUT_PARAMETER_OUT_OF_RANGE = 539; 

const short INVALID_PARAMETER = 540; 

const short INVALID_POINTER = 541; 

const short MESSAGE_NOT_EXPECTED = 542; 

const short MESSAGE_NOT_INITIALIZED = 543; 

const short MESSAGE_OUT_OF_SEQUENCE = 544; 

const short SYSTEM_CALL_UNSUCCESSFUL = 54 5; 

const short TIMEOUT_EXPIRED = 546; 

const short VARIABLE_OUT_OF_RANGE = 547; 

const short WATCH_DOG_TIMER_EXPIRED = 548; 

const short COOLING_SYSTEM_FAILURE = 549; 

const short EXTERNAL_EQUIPMENT_FAILURE = 550; 

const short EXTERNAL_POWER_SUPPLY_FAILURE = 551; 

const short EXTERNAL_TRANSMISSION_DEVICE_FAILURE = 552; 

// Values 553-560 correspond to duplicated probable causes 

const short REDUCED_ALARM_REPORTING = 561; 

const short REDUCED_EVENT_REPORTING = 562; 

const short RECUCED_LOGGING_CAPABILITY = 563; 

const short SYSTEM_RESOURCES_OVERLOAD = 564; 

const short BROADCAST_CHANNEL_FAILURE = 565; 

const short CONNECTION ESTABLISHMENT ERROR = 566; 
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const short INVALID_MESSAGE_RECEIVED = 567; 

const short INVALID_MSU_RECEIVED = 568; 

const short LAPD_LINK_PROTOCOL_FAILURE = 569; 

const short LOCAL_ALARM_INDICATION = 570; 

const short REMOTE_ALARM_INDICATION = 571; 

const short ROUTING_FAILURE = 572; 

const short SS7_PR0T0C0L_FAILURE = 573; 

const short TRANSMISSION_ERROR = 574; 

// Value 575 corresponds to a duplicated probable cause 

// Values 576-700 are reserved for potential future extensions 

// for 2G & 3G wireless systems 

/* 

Probable causes originating from M.SIOO security alarm causes. 

Values below correspond to M.SIOO values with an offset of 700. 

const short AUTHENTICATION_FAILURE = 701; 

const short BREACH_OF_CONFIDENTIALITY = 702; 

const short CABLE_TAMPER = 703; 

const short DELAYED_INFORMATION = 704; 

const short DENIAL_OF_SERVICE = 705; 

const short DUPLICATE_INFORMATION = 706; 

const short INFORMATION_MISSING = 707; 

const short INFORMATION_MODIFICATION_DETECTED = 708; 

const short INFORMATION_OUT_OF_SEQUENCE = 709; 

// Value 710 corresponds to a duplicated probable cause 

const short KEY_EXPIRED = 711; 

const short NON_REPUDIATION_FAILURE = 712; 

const short OUT_OF_HOURS_ACTIVITY = 713; 

const short OUT_OF_SERVICE = 714; 

const short PROCEDURAL_ERROR = 715; 

const short UNAUTHORISED_ACCESS_ATTEMPT = 716; 

const short UNEXPECTED_INFORMATION = 717; 

const short UNSPECIFIED_REASON = 718; 

// Values 719-800 are reserved for potential M.3100 future extensions 

}; 
/* 

This block identifies the acknowledgement state of a reported alarm. 

*/ 

interface AckState 

{ 

const short ACKNOWLEDGED = 1; 
const short UNACKNOWLEDGED = 2; 

}; 
/* 

This block identifies attributes which are included as part of the Alarm IRP 

These attribute values should not clash with those defined for the attributes 

of notification header {see IDL of Notification IRP) . 

*/ 

interface AttributeNameValue 

{ 

const string ALARM_ID = "f"; 
const string PROBABLE_CAUSE = "g" ; 
const string PERCEIVED_SEVERITY = "h" ; 
const string SPECIFIC_PROBLEM = "i"; 
const string ADDITIONAL_TEXT = "j"; 
const string ACK_TIME = "k" ; 
const string ACK_USER_ID = "1"; 
const string ACK_SYSTEM_ID = "m" ; 
const string ACK_STATE = "n" ; 
const string COMMENTS = "o" ; 
const string BACKED_UP_STATUS = "p" ; 
const string BACK_UP_OBJECT = "q" ; 
const string THRESHOLD_INFO = "r"; 
const string TREND_INDICATION = "s"; 
const string STATE_CHANGE_DEFINITION = "t"; 
const string MONITORED_ATTRIBUTES = "u" ; 
const string PROPOSED_REPAIR_ACTIONS = "v" ; 
const string CORRELATED_NOTIFICATIONS = "w" ; 
const string REASON = "x" ; 
const string CLEAR_USER_ID = "y" ; 
const string CLEAR_SYSTEM_ID = "z"; 

const string ALARM_LIST_ALIGNMENT_REQUIREMENT = "ff"; 
const string SERVICE_USER = "gg" ; 
const string SERVICE_PROVIDER = "hh" ; 
const string SECURITY_ALARM_DETECTOR = "ii"; 
const string ALARM_RAISED_TIME = "kk" ; 
const string ALARM_CLEARED_TIME = "11"; 
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/* 

constants for use in populating the additional information 

name field Names 
*/ 
interface Additionallnformation 

{ 

const string AI_VS_PERCEIVED_SEVERITY = "ai_ps"; 
const string AI_VS_ALARM_TYPE = "ai__at"; 

}; 

/* 

Defines the content of a Comment 

*/ 

struct Comment 

{ 

ManagedGenericIRPConstDef s : : IRPTime comment_time; 
string comment_text ; 
string user_id; 
string system_id; 

}; 
/* 

Defines a set of comments which are placed in the COMMENTS attribute 

of a structured event . 

*/ 

typedef sequence <Comment> CommentSet; 

/* 

It indicates if an object has a back up. 

True implies backed up. False implies not backed up. 

*/ 

typedef boolean BackedUpStatus; 

/* 

It indicates if the threshold crossed was in the up or down direction. 

*/ 

enum Thresholdlndication {UP, DOWN}; 

/* 

It indicates if the AlarmList alignment is required. 

*/ 

enum AlarmListAlignmentRequirement {REQUIRED, NOTREQUIRED} ; 

/* FloatOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise the value is null. 

*/ 

union FloatOpt switch (boolean) 

{ 

case TRUE: float value; 

}; 

/* ThresholdLevelInd describes multi-level 
threshold crossings. 

Up is the only permitted choice for a counter. 
If indication is "up", low value is optional, 
©member indication: indicates up or down direction 

of crossing, 
©member low: the low observed value, 
©member high: the high observed value. 

struct ThresholdLevelInd 

{ 

Thresholdlndication indication; 
FloatOpt low; 
float high; 

}; 

/* ThresholdLevellndOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise, the value is null. 

*/ 

union ThresholdLevellndOpt switch (boolean) 

{ 

case TRUE: ThresholdLevelInd value; 

}; 

/* Thresholdinf o indicates some gauge or counter 

attribute passed a set threshold. 

©member attribute_id: identifies the attribute that 

crossed the threshold, 
©member observed_value : attributes that are of type 

integer will be converted to floats, 
©member threshold_level : This parameter is for 

multi-level thresholds. Optional, 
©member arm_time: May contain empty string. 
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*/ 

struct Thresholdinf o 

{ 

string attribute_id; 
float observed_value; 

ThresholdLevellndOpt threshold_level ; 
string arm_time; 

}; 
/* 

It indicates if some observed condition is getting better, worse, 
or not changing. 

enum Trendlndication {LESS_SEVERE, N0_CHANGE, M0RE_SEVERE } ; 

/* 

It is used to report a changed attribute value. 

*/ 

struct AttributeValueChange 

{ 

string attribute_name; 

any old_value,- // type depends on attribute 

any new_value; // type depends on attribute 

}; 

typedef sequence <AttributeValueChange> AttributeChangeSet ; 

/* 

It is used to report an attribute and its value. 

*/ 

struct AttributeValue 

{ 

string attribute_name,- 

any value; // type depends on the attribute 

}; 

typedef sequence <AttributeValue> AttributeSet ; 

typedef sequence <long> NotifldSet; 

/* 

This holds identifiers of notifications that are correlated. 

struct CorrelatedNotif ication 

{ 

DN source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero- length string. In this case, the MO 
// is identified by the value of the MOI attribute 
// of the Structured Event, i.e., the notification. 
NotifldSet notif_id_set ; // Set of related notification ids 

}; 
/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

*/ 

typedef sequence <CorrelatedNotif ication> CorrelatedNotif icationSet; 

/* 

Define the structure of Alarm ID and Perceived Severity used within the 

alarm acknowledgment operation. Note: perceived_severity is an optional 

parameter. If this value is present, it must have one of the defined values 

of Interface PerceivedSeverity . 

*/ 

struct AlarmlnformationldAndSev 

{ 

string alarm_id; 

ManagedGenericIRPConstDef s : : ShortOpt perceived_severity; 

}; 
/* 

Define set of the above structure of Alarm ID and Perceived Severity. 

typedef sequence <AlarmInformationIdAndSev> AlarmlnformationldAndSevSeq; 

/* 

It indicates the reason for an alarm acknowledgement to have failed: 

- The specified Alarm Information is absent from the Alarm List 

- The Perceived Severity to be acknowledged has changed and/or is different 
within the Alarm List 

- The acknowledgement failed for some other reason 
*/ 

enum AcknowledgeFailureCategories 

{ 

UNKNOWN_ALARM_ID , 
WRONG_PERCEIVED_SEVERITY, 
ACKNOWLEDGMENT FAILED 
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/* 

Define the structure returned when an operation fails for a set of alarm ids. 

A reason is provided in order to indicate why the operation failed. 

*/ 

struct BadAlarmlnformationId 

{ 

string alarm_id; 
string reason; 

}; 
/* 

Define the structure returned when the acknowledge operation fails for a set 

of alarm ids. 

A failure category and a reason are provided in order to indicate why the 

operation failed. 

*/ 

struct BadAcknowledgeAlarmlnfo 

{ 

string alarm_id; 

AcknowledgeFailureCategories f ailure_category,• 
string reason; 

}; 

typedef sequence <BadAlarmInformationId> BadAlarmlnformationldSeq; 

typedef sequence <BadAcknowledgeAlarmInfo> BadAcknowledgeAlarmlnfoSeq; 

typedef sequence <string> AlarmlnformationldSeq; 

typedef CosNotif ication: : EventBatch AlarmlnformationSeq; 

/* 

Define the cause values of notifyPotentialFaultyAlarmList and 

notifyAlarmListRebuilt , which have been defined in 32111-2. 

const string AGENT_NE_COMMUNICATION_ERROR = "Agent-NE communication error" ; 
const string AGENT_RESTARTS = "Agent restarts"; 
const string INDETERMINATE = "Indeterminate"; 

}; 

#endif // _ALARM_IRP_CONST_DEFS_IDL 
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A.2 IDL specification (file name 'AlarmlRPSystem.idl') 

//File: AlarmlRPSystem.idl 
iifndef _ALARM_IRP_SYSTEM_IDL_ 
#define _ALARM_IRP_SYSTEM_IDL_ 

#include <AlarmIRPConstDef s . idl> 
#include <ManagedGenericIRPSystem. idl> 

// This statement must appear after all include statements 
ipragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPSystem 

This module contains the specification of all operations of Alarm IRP Agent. 



*/ 

module AlarmlRPSystem 

{ 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetAlarmlRPVersions { string reason; } ; 

exception GetAlarmlRPOperationsProf ile { string reason; }; 

exception GetAlarmlRPNotif icationProf ile { string reason; }; 

exception AcknowledgeAlarms { string reason; }; 

exception UnacknowledgeAlarms { string reason; }; 

exception CommentAlarms { string reason; }; 

exception ClearAlarms { string reason; }; 

exception GetAlarmList { string reason; }; 

exception GetAlarmCount { string reason; }; 

exception NextAlarmlnformations { string reason; }; 

exception FilterComplexityLimit { string reason; }; 

/* 

The Alarmlnformationlterator is used to iterate through a snapshot of 

Alarm Informations taken from the Alarm List when IRPManager invokes 

get_alarm_list . IRPManager uses it to pace the return of Alarm 

Informations . 

IRPAgent controls the life-cycle of the iterator. However, a destroy 

operation is provided to handle the case where IRPManager wants to stop 

the iteration procedure before reaching the last iteration. 

*/ 

interface Alarmlnformationlterator 

{ 

/* 

This method returns between 1 and "how_many" Alarm Informations. The 

IRPAgent may return less than "how_many" items even if there are more 

items to return. "how_many" must be non-zero. Return TRUE if there may 

be more Alarm Information to return. Return FALSE if there are no more 

Alarm Information to be returned. 

If FALSE is returned, the IRPAgent will automatically destroy the 

iterator. 

*/ 

boolean next_alarm_informations { 

in unsigned short how_many, 

out AlarmlRPConstDef s : : Alarmlnf ormationSeq alarm_inf ormations 
) 
raises {NextAlarmlnformations, ManagedGenericIRPSystem: : InvalidParameter) 



/* 

This method destroys the iterator. 

*/ 

void destroy {) ; 



interface AlarmlRP 

{ 

/* 

Return the list of all supported Alarm IRP versions. 

Implementations are to provide a return value consisting of one or more 

IRPVersions . 

Each IRPVersion is defined by the rule in the clause titled 

"IRP document version number string" 
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*/ 

ManagedGenericIRPConstDef s : : VersionNumberSet get_alarm_irp_versions { 

) 

raises (GetAlarmlRPVersions) ; 

/* 

Return the list of all supported operations and their supported 
parameters for a specific Alarm IRP version. 

ManagedGenericIRPConstDef s : iMethodList get_alarm_irp_operations_prof ile { 

in ManagedGenericIRPConstDef s : iVersionNumber alarm_irp_version 
) 
raises {GetAlarmlRPOperationsProf ile, 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Return the list of all supported notifications and their supported 
parameters for a specific Alarm IRP version. 
*/ 

ManagedGenericIRPConstDef s : iMethodList get_alarm_irp_notif ication_prof ile 
{ 

in ManagedGenericIRPConstDef s : iVersionNumber alarm_irp_version 
) 
raises {GetAlarmlRPNotif icationProf ile , 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to acknowledge one or more alarms. 
*/ 

ManagedGenericIRPConstDef s :: Signal acknowledge_alarms { 
in AlarmlRPConstDef s : lAlarmlnformationldAndSevSeq 

alarm_information_id_and_sev_list , 
in string ack_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt ack_system_id, 
out AlarmlRPConstDef s : iBadAcknowledgeAlarmInf oSeq 
bad_ack_alarm_inf o_list 
) 

raises {AcknowledgeAlarms, ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to remove acknowledgement information of one or more alarms. 

*/ 

ManagedGenericIRPConstDef s :: Signal unacknowledge_alarms { 

in AlarmlRPConstDef s : :AlarmInformationIdSeq alarm_information_id_list , 

in string ack_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt ack_system_id, 

out AlarmlRPConstDef s : :BadAlarmInformationIdSeq 
bad alarm information id list 



raises {UnacknowledgeAlarms, 

ManagedGenericIRPSystem: 
ManagedGenericIRPSystem: 
ManagedGenericIRPSystem : 



OperationNot Supported, 
ParameterNotSupported, 
InvalidParameter) ; 



/* 

Make comment to one or more alarms . 

*/ 

ManagedGenericIRPConstDef s :: Signal comment_alarms { 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 
in string comment_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt comment_system_id, 
in string comment_text , 

out AlarmlRPConstDef s : :BadAlarmInf ormationldSeq 
bad_alarm_information_id_list 
) 

raises {CommentAlarms, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to clear one or more alarms. 

*/ 

ManagedGenericIRPConstDef s :: Signal clear_alarms { 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 

in string clear_user_id. 
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in ManagedGenericIRPConstDef s : : StringOpt clear_system_id, 
out AlarmlRPConstDef s : iBadAlarmlnformationldSeq 
bad_alarm_inf ormation_id_list 
) 

raises {ClearAlarms, ManagedGenericIRPSystem: lOperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns Alarm Informations. 

If flag is TRUE, all returned Alarm Informations shall be 

in AlarmlnformationSeq that contains or more Alarm Informations. 

Output parameter iter shall be useless. 

If flag is FALSE, no Alarm Informations shall be in AlarmlnformationSeq. 

IRPAgent needs to use iter to retrieve them. 

*/ 

AlarmlRPConstDef s : lAlarmlnformationSeq get_alarm_list { 

in ManagedGenericIRPConstDef s :: StringOpt filter, 

in AlarmlRPConstDef s : iDNOpt base_object, 

out boolean flag, 

out Alarmlnf ormationlterator iter 
) 

raises {GetAlarmList , FilterComplexityLimit , ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns the count of Alarm Informations. 

*/ 

void get_alarm_count { 

in ManagedGenericIRPConstDef s :: StringOpt filter, 

out unsigned long critical_count , 

out unsigned long major_count, 

out unsigned long minor_count, 

out unsigned long warningcount , 

out unsigned long indeterminate_count , 

out unsigned long cleared_count 
) 

raises {GetAlarmCount , FilterComplexityLimit, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif // _ALARM_IRP_SYSTEM_IDL_ 
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A.3 IDL specification (file name 
"AlarmlRPNotifications.idl") 

//File : AlarmlRPNotif ications . idl 
#ifndef _ALARM_IRP_NOTIFICATIONS_IDL_ 
#define _ALARM_IRP_NOTIFICATIONS_IDL_ 

#include <AlarmIRPConstDef s . idl> 

#include <NotificationIRPNotif ications . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPNotif ications 

This module contains notifications for Alarm IRP 

*/ 

module AlarmlRPNotif ications 



interface NotifyNewAlarm: NotificationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyNewAlarm" ; 

/** 

* This constant defines the name of the probableCause property. 

* The data type for the value of this property 

* is short. 
*/ 

const string PROBABLE_CAUSE = 

AlarmlRPConstDefs: lAttributeName Value : : PROBABLE_CAUSE; 

/** 

* This constant defines the name of the 

* perceivedSeverity property. 

* The data type for the value of this property 

* is short. 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: :AttributeName Value : : PERCEIVED SEVERITY; 



/** 

* This constant defines the name of the specif icProblem 

* property. The data type for the value of this property 

* is string. 
*/ 

const string SPECIFIC_PROBLEM = 

AlarmlRPConstDefs: :AttributeName Value : : SPECIFIC_PROBLEM; 

/** 

* The two constants defines the name of the additionallnformation 

* property {the vendor- specif ic (VS) perceived severity and alarm type) 

* The data type for the value of this property 

* is string. 
*/ 

const string AI_VS_PERCEIVED_SEVERITY = 

AlarmlRPConstDefs : : Additionallnformation: : AI_VS_PERCEIVED_SEVERITY; 
const string AI_VS_ALARM_TYPE = 

AlarmlRPConstDefs: : Additionallnformation: :AI_VS_ALARM_TYPE; 

/** 

* This constant defines the name of the 

* correlatedNotif ications property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s :: CorrelatedNotif icationSet . 

*/ 
const string CORRELATED_NOTIFICATIONS = 
AlarmlRPConstDefs: : AttributeName Value : : 
CORRELATED_NOTIFICATIONS ; 

/** 
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* This constant defines the name of the 

* backedUpStatus property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : iBackedUpStatus . 
*/ 

const string BACKED_UP_STATUS = 

AlarmlRPConstDef s: lAttributeName Value : : BACKED_UP_STATUS ; 

/** 

* This constant defines the name of the backUpObject property. 

* The data type for the value of this property 

* is a string carrying of DN of the back-up object. 
*/ 

const string BACK_UP_OBJECT = 

AlarmlRPConstDef s: lAttributeName Value : :BACK_UP_OBJECT; 

/** 

* This constant defines the name of the 

* trendlndication property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : iTrendlndication. 
*/ 

const string TREND_INDICATION = 

AlarmlRPConstDef S: : AttributeName Value : :TREND_INDICATION; 

/** 

* This constant defines the name of the thresholdinf o property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : iThresholdlnfo. 

*/ 
const string THRESHOLD_INFO = 

AlarmlRPConstDef s: lAttributeName Value : : THRESHOLD_INFO; 

/** 

* This constant defines the name of the 

* stateChangeDef inition property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : lAttributeChangeSet . 
*/ 

const string STATE_CHANGE_DEFINITION = 

AlarmlRPConstDef s: lAttributeName Value : : STATE_CHANGE_DEFINITION; 

/** 

* This constant defines the name of the 

* monitoredAttributes property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : lAttributeSet . 
*/ 

const string MONITORED_ATTRIBUTES = 

AlarmlRPConstDef s: lAttributeName Value : :MONITORED_ATTRIBUTES; 

/** 

* This constant defines the name of the 

* proposedRepairActions property. 

* The data type for the value of this property 

* is string. 
*/ 

const string PROPOSED_REPAIR_ACTIONS = 

AlarmlRPConstDef s : lAttributeName Value : : PROPOSED_REPAIR_ACTIONS; 

/** 

* This constant defines the name of the additionalText 

* property. 

* The data type for the value of this property 

* is string. 

const string ADDITIONAL_TEXT = 

AlarmlRPConstDef s: : AttributeName Value : : ADDITIONAL_TEXT; 

/** 

* This constant defines the name of the alarmld property. 

* The data type for the value of this property 

* is string. If the string is a zero-length string or if 

* this NV pair is absent, the default semantics is that 

* alarmld is a concatenation of 

* managedObjectlnstance, eventType, probableCause and 

* specif icProblem, if present, of this Structured Event. 

* Since probableCause is encoded as a short, it shall be 
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* converted into string before concatenation. 

* The resultant string shall not contain spaces. 
*/ 

const string ALARM_ID = 

AlarmlRPConstDef s : lAttributeName Value : :ALARM_ID; 

/** 

* This constant defines the name of the serviceUser property. 

* The data type for the value of this property 

* is string. 
*/ 

const string SERVICE_USER = 

AlarmlRPConstDef s: lAttributeName Value : : SERVICE_USER; 

/** 

* This constant defines the name of the serviceProvider 

* property. 

* The data type for the value of this property 

* is string. 
*/ 

const string SERVICE_PROVIDER = 

AlarmlRPConstDef S: : AttributeName Value : : SERVICE_PROVIDER; 

/** 

* This constant defines the name of the 

* securityAlarmDetector property. 

* The data type for the value of this property 

* is string. 
*/ 

const string SECURITY_ALARM_DETECTOR = 

AlarmlRPConstDef s : lAttributeName Value : : SECURITY_ALARM_DETECTOR; 

}; 

interface NotifyAckStateChanged: 

Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyAckStateChanged" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDef s: : AttributeName Value : : PROBABLE_CAUSE; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDef s: lAttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDef s : lAttributeName Value : :ALARM_ID; 

/** 

* This constant defines the name of the ackTime property. 

* The data type for the value of this property 

* is ManagedGenericIRPConstDef s : : IRPTime. 
*/ 

const string ACK_TIME = 

AlarmlRPConstDef s: lAttributeName Value : : ACK_TIME; 

const string ACK_USER_ID = 

AlarmlRPConstDef s: lAttributeName Value : :ACK_USER_ID; 

const string ACK_SYSTEM_ID = 

AlarmlRPConstDef s: lAttributeName Value : :ACK_SYSTEM_ID; 

const string ACK_STATE = 

AlarmlRPConstDef s : lAttributeName Value : :ACK_STATE; 

}; 

interface Notif yClearedAlarm: Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyClearedAlarm" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDef s: lAttributeName Value : : PROBABLE_CAUSE; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDef s: : AttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDef s : lAttributeName Value : : ALARM ID; 
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const string CLEAR_USER_ID = 

AlarmlRPConstDefs: lAttributeName Value : : CLEAR_USER_ID; 

const string CLEAR_SYSTEM_ID = 

AlarmlRPConstDefs: lAttributeName Value : : CLEAR_SYSTEM_ID; 
}; 

interface NotifyAlarmListRebuilt : 

Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyAlarmListRebuilt " ; 

const string REASON = 

AlarmlRPConstDefs: : AttributeName Value : : REASON; 

const string ALARM_LIST_ALIGNMENT_REQUIREMENT = 
AlarmlRPConstDefs: : AttributeName Value : : 
ALARM_L I ST_AL I GNMENT_REQUI REMENT ; 

}; 

interface Notif yChangedAlarm: Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyChangedAlarm" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDefs: : AttributeName Value : : PROBABLE_CAUSE; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: : AttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDefs: : AttributeName Value : :ALARM_ID; 

}; 

interface NotifyComments : Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyComments" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDefs: : AttributeName Value : : PROBABLE_CAUSE; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: : AttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDefs: : AttributeName Value : :ALARM_ID; 

/** 

* This constant defines the name of the comments property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : :CommentSet . 
*/ 

const string COMMENTS = 

AlarmlRPConstDefs: : AttributeName Value : : COMMENTS; 
}; 

interface NotifyPotentialFaultyAlarmList : 
Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyPotentialFaultyAlarmList " ; 

/** 

* This constant defines the name of the reason property. 

* The data type for the value of this property 

* is string. 

const string REASON = 

AlarmlRPConstDefs: : AttributeName Value : :REASON; 

}; 



#endif // ALARM IRP NOTIFICATIONS IDL 
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